home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / S-ICE252.ZIP / README.SI < prev    next >
Text File  |  1991-12-23  |  11KB  |  257 lines
  1.    List    of sections within this    file:
  2.  
  3. 1. INSTALLING SOFT-ICE
  4. 2. INSTALLING WITH DOS 5
  5. 3. PATCH TO SOFT-ICE TO    RUN MAGIC CV WITH CODEVIEW 3.14
  6. 4. BATCH FILES FOR COMPILING WITH MICROSOFT C COMPILERS
  7. 5. BATCH FILES FOR COMPILING WITH BORLAND C++ COMPILERS
  8. 6. BATCH FILE FOR COMPILING WITH BORLAND TURBO PASCAL
  9. 7. CONFIG EDIT
  10. 8. MSYM    WARNINGS
  11. 9. COMPILING WITH TOPSPEED
  12.  
  13. --------------------------------------------------------------------------
  14. 1. INSTALLING SOFT-ICE
  15. --------------------------------------------------------------------------
  16.  
  17.   When Soft-ICE    is copied to a system, EMMSETUP    should be run to insure
  18. that the internal EMM map within S-ICE.EXE matches the configuration of    
  19. that system. When running EMMSETUP, first select "Reconfigure Driver to 
  20. Current    Configuration". If you have any I/O adapters which use memory, 
  21. such as    network    cards, select "Manual Configuration and Status Screen" 
  22. and X-out the block of memory used. After exiting EMMSETUP, check the 
  23. date and time on S-ICE.EXE to insure that it has been changed.
  24.  
  25.   When Soft-ICE    is installed in    the CONFIG.SYS file, the switches are
  26. assigned as follows:
  27.   /EXT reserves    XMS memory from    the 1Mb    boundary on up for drivers such    as
  28. HIMEM, CACHE, SMARTDRV and RAMDRIVE. HIMEM.SYS uses 64K    of XMS memory, and
  29. the others use the amount specified in their switches. Add these up and
  30. set the    EXT switch to this total.
  31.   /SYM reserves    space to store the symbolic debug data and the source 
  32. files. The amount needed depends on the    user's application, but usually 
  33. the largest portion is for storing the source files. This space    is in 
  34. extended memory, just below Soft-ICE (which is at the top of extended 
  35. memory). In many cases a large amount of SYM space is necessary.
  36.   /EMM reserves    space for use as emulated expanded memory. It is used by 
  37. SMARTDRV and RAMDRIVE with the /A switch, and sometimes    by application 
  38. programs. On some systems, CodeView 3.11 and 3.14 will run only    in 
  39. expanded memory. This space is reserved    just below the /SYM space.
  40.  
  41. --------------------------------------------------------------------------
  42. 2. INSTALLING WITH DOS 5
  43. --------------------------------------------------------------------------
  44.  
  45.    S-ICE.EXE must be used as the EMS memory manager (do    not use    EMM386).
  46.    HIMEM.SYS must be after S-ICE.EXE, not before. When HIMEM.SYS is 
  47. loaded,    it displays the    message    "Installed A20 Handler"    followed by a
  48. number.    If the number is not "1" or "2", you must use the switch "/m:1"    
  49. with HIMEM.SYS.
  50.    DOS 5.0 may be loaded high with the "dos = high" command. Note that
  51. HIMEM.SYS must be installed to use this.
  52.    If you wish to load drivers and T&SR's high, you must configure the
  53. memory manager for this    using EMMSETUP (or BCSETUP for BC.SYS).
  54.    If you do not have our utility UMB.SYS, you must use    our Load High 
  55. utilities (LD.SYS and LH.EXE). Since the DOS 5.0 load high utility is 
  56. called by "LH",    rename ours to LHIGH.EXE. In this case you cannot use 
  57. "dos = umb". Your CONFIG.SYS file should look something    like this:
  58.     dos = high
  59.     device = c:\si\ce.exe        ;configuration editor
  60.     device = c:\si\s-ice.exe /SYM 500 /EXT 2112 /EMM
  61.     device = c:\dos\himem.sys /m:1
  62.     device = c:\si\ld.sys c:\dos\smartdrv.sys 2048
  63.     device = c:\si\ld.sys c:\ansi.sys
  64. etc...
  65.  
  66.    If you have UMB.SYS,    you may    install    this driver to allow using the DOS
  67. 5 UMB functions    and load-high utilities. In this case your CONFIG.SYS file
  68. would look something like this:
  69.    
  70.     dos = high,umb
  71.     device = c:\si\ce.exe        ;configuration editor
  72.     device = c:\si\s-ice.exe /SYM 500 /EXT 2112 /EMM
  73.     device = c:\dos\himem.sys /m:1
  74.     device = c:\si\umb.sys
  75.     devicehigh = c:\dos\smartdrv.sys 2048
  76.     devicehigh = c:\ansi.sys
  77. etc...
  78.  
  79. --------------------------------------------------------------------------
  80. 3. PATCH TO SOFT-ICE TO    RUN MAGIC CV WITH CODEVIEW 3.14
  81. --------------------------------------------------------------------------
  82.  
  83.    This    is a patch to Soft-ICE to allow    MagicCV    3.0 to work with
  84. CodeView 3.14. Where it    says something like "xxxx:wwww+1", if the
  85. address    printed    was 2C58:6CBA, use "2C58:6CBB",    etc.
  86.    Some    users have reported slightly different addresses in earlier
  87. versions of Soft-ICE (e.g., 6C85 instead of 6CBA).
  88.  
  89. ren s-ice.exe s-ice.bin
  90. debug s-ice.bin
  91. -s cs:0    lffff 42 22
  92. prints address in xxxx:wwww format (wwww should    be 6CBA)
  93. -e xxxx:wwww+1 1e
  94. -s cs:0    lffff 5a 20
  95. prints address in xxxx:yyyy format (yyyy should    be 6CC5)
  96. prints address in xxxx:zzzz format (zzzz should    be 6D0B)
  97. -e xxxx:yyyy+1 1c
  98. -e xxxx:zzzz+1 1c
  99. -w
  100. -q
  101. ren s-ice.bin s-ice.exe
  102.  
  103.  
  104.    Also, you must use either the /D or the /E switch with MCV. Since the 
  105. /E switch requires setting up expanded memory, we recommend trying the /D 
  106. switch first.
  107.  
  108. --------------------------------------------------------------------------
  109. 4. BATCH FILES FOR COMPILING WITH MICROSOFT C COMPILERS
  110. --------------------------------------------------------------------------
  111.  
  112. This is    a sample batch file for    Microsoft C 6.0    using a    Large memory 
  113. model, without a floating point    coprocessor.
  114.  
  115.  c600\bin\cl /AL /Zi /c    %1.c
  116.  c600\bin\link /MA /CO /LI %1,%1,%1,c600\lib\llibce,;
  117.  
  118. For other models:change    /AL:    change llibce:    if hardware FP,    llibc7
  119.     SMALL        /AS           slibce            slibc7
  120.     MEDIUM        /AM           mlibce            mlibc7
  121.     COMPACT        /AC           clibce            clibc7
  122.     HUGE        /AH           hlibce            hlibc7
  123.  
  124. --------------------------------------------------------------------------
  125. 5. BATCH FILES FOR COMPILING WITH BORLAND C++ COMPILERS
  126. --------------------------------------------------------------------------
  127.  
  128. This is    a sample batch file for    Turbo/Borland C++ using    a Large    memory 
  129. model, without a floating point    coprocessor. It    is run from the    tc\lib
  130. directory to avoid having to specify the path for all the library files
  131. called in the tlink command line:
  132.  
  133.  cd tc\lib
  134.  tc\tcc    -v -ml -Itc\include -c c:\%1.c
  135.  tc\tlink /v/s/l/c c0l %1,c:\%1,c:\%1,emu mathl    cl
  136.  cd\
  137.  
  138. Other models: change -ml:   change c0l:     change    mathl:     change    cl:
  139.       SMALL         -ms       c0s        maths        cs
  140.       MEDIUM         -mm       c0m        mathm        cm
  141.       COMPACT         -mc       c0c        mathc        cc
  142.       HUGE         -mh       c0h        mathh        ch
  143. For hardware FP    (80x87)    use "fp87" in place of "emu" in    the link line.
  144.  
  145. --------------------------------------------------------------------------
  146. 6. BATCH FILE FOR COMPILING WITH BORLAND TURBO PASCAL
  147. --------------------------------------------------------------------------
  148.  
  149.  The following batch file format is recommended:
  150.  
  151.        tpc %1 /B/GD/$E+/$F+/$S+/$L+
  152.        msym    %1
  153.  
  154. --------------------------------------------------------------------------
  155. 7. CONFIG EDIT
  156. -------------------------------------------------------------------------
  157. CONFIG EDIT (CE.EXE) is    an on-the-fly editor for CONFIG.SYS. Install
  158. CE.EXE as the 1st "DEVICE=" in your CONFIG.SYS file.
  159.  
  160. When your system boots,    you will hear a    tone.  You have    a short    time to
  161. press any key after the    tone. If you press a key CE will take over. CE
  162. allows changing    CONFIG.SYS before using    it. 
  163.  
  164. CE.EXE Version 2.0 also    lists all the CONFIGxx.xxx files, and allows 
  165. choosing which one to boot with. The chosen CONFIGxx.xxx file may be 
  166. edited permanently or on a one-time basis before booting. CE.EXE must 
  167. be the first driver in all the CONFIGxx.xxx files, because it cleans up    
  168. for the    previous bootup    operation before booting.
  169.  
  170. MAIN FUNCTIONS WITHIN THE CE.EXE MENU:
  171.  
  172. ESC   -    Boot using the current CONFIG.SYS file.
  173.  
  174. ENTER -    Boot using the selected    file without editing.
  175.  
  176. F10   -    Boot using the selected    file without editing, and copy it into 
  177.     CONFIG.SYS. The    previous CONFIG.SYS is saved as    CONFIG.BAK.
  178.  
  179. F2    -    Edit the selected file before booting. To exit the edit    session
  180.     select ESC, F1 or F10 (see below).
  181.  
  182.     ESC   -    Exit the edit session with no changes.
  183.  
  184.     F1    -    Change the selected file for this boot only. The changes 
  185.         are not    permanant.
  186.  
  187.     F10   -    Change the selected file permanently (including    for this
  188.         boot).
  189.  
  190. OTHER IMPORTANT    NOTES:
  191.  
  192. CE can also be run from    the command line.  This    is for a quick look or
  193. quick changes to CONFIG.SYS.
  194.  
  195. The /Q switch (Quiet) will disable the initial sound made by CE.EXE when
  196. it is installed    in CONFIG.SYS.
  197.  
  198. -------------------------------------------------------------------------
  199. 8. MSYM    WARNINGS
  200. -------------------------------------------------------------------------
  201.    When    the compiler does not produce correct debug information    in the
  202. .EXE file, the .EXE file must be made without debug information, and a 
  203. .MAP file with line-number data    must be    created. MSYM must be used to 
  204. make a .SYM file from the .MAP file so that Soft-ICE can get the symbolic
  205. and source information correctly.
  206.  
  207.    MSYM    requires a Microsoft-compatible    .MAP file with at least    one real
  208. Public symbol. It returns the message "Hex Value Expected" if no Public    
  209. symbol is found. This is common    with Assembly language programs    because
  210. public symbols must be declared    specifically, while higher language
  211. compilers typically make all procedure names public.
  212.  
  213.    If all the Public symbols in    the .MAP file are Absolute, or if some
  214. modules    do not have a Class, an    invalid    .SYM file may be produced, which
  215. can cause problems when    running    Soft-ICE.
  216.  
  217.    MSYM    searches for the strings "Start" and "Publics by Value"    within 
  218. the .MAP file, and will    return an error    message    if these exact strings
  219. are not    found.
  220.  
  221.    The versions    of MSYM    prior to November 1991 cannot correctly    process    
  222. public names longer than 49 characters.    If a longer name is encountered, 
  223. it prints the message "String not found" with no name, and then    aborts.    
  224. Zortech    C++ and    Borland    C++ allow function names to include their entire 
  225. argument list, so such errors are likely to occur when using these 
  226. compilers. Versions of MSYM dated from November    1991 and later allow 
  227. public names up    to 250 characters long.
  228.  
  229. -------------------------------------------------------------------------
  230. 9. COMPILING WITH TOPSPEED
  231. -------------------------------------------------------------------------
  232.     The    following is a recommended project file    format for compiling with
  233. Topspeed (large    model):
  234.  
  235. #system    auto exe
  236. #model large jpi
  237. #pragma    debug(vid=>full)
  238. #pragma    debug(line_num=>on)
  239. #compile %main
  240. #link %prjname
  241.  
  242.     This creates a detailed map    file. Use our MSYM.EXE utility to create
  243. a .SYM file using the command:
  244.     msym program-name        
  245.     Bounds-Checker will    extract    the debug information from this    file.
  246.  
  247.     The    following is a recommended batch file format (large model):
  248.  
  249. c:\ts\sys\tsc c:\%1.c /m /ml /v2 /debug(line_num=on)
  250. msym %1
  251.  
  252.     Topspeed does not generate line-number debug information for the line
  253. containing "main". In some cases this prevents being able to display
  254. source code.
  255.  
  256. -------------------------------------------------------------------------
  257.